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1  Introduction 

The  NIST  STEP  physical  file  parser  [Clark90c],  and  its  associated  STEP  parser, 
STEPparse,  are  Public  Domain  tools  for  manipulating  product  models  stored  in  the 
STEP  physical  file  format  [AltemuellerSS].  TTiese  tools  are  a  part  of  the  NIST  PDES 
Toolkit  [Clark90a],  and  are  geared  particularly  toward  building  STEP  translators.  This 
reference  manual  discusses  the  internals  of  the  STEP  Working  Form,  including 
STEPparse.  The  reader  is  assumed  to  be  familiar  with  the  design  of  the  Toolkit 
([Clark90a],  [Clark90b],  [Clark90c]).  In  some  cases,  technical  knowledge  of  the  Ex¬ 
press  Working  Form  [Clark90e]  is  also  required. 

The  STEP  Working  Form  relies  on  the  NIST  Express  Working  Form  [Clark90b]  as  an 
in-core  data  dictionary,  which  provides  a  context  in  which  STEP  models  can  be  inter¬ 
preted.  The  tight  dependency  of  the  STEP  Working  Form  abstractions  on  those  of  the 
Express  Working  Form  is  due  to  the  schema-independent  nature  of  the  former.  The 
STEP  Working  Form,  and,  in  particular,  STEPparse,  contain  no  knowledge  of  any  par¬ 
ticular  information  model.  Applications  built  on  these  tools  can  thus  manipulate  STEP 
product  models  in  the  context  of  any  number  of  Express  information  models  without 
requiring  recompilation. 

1.1  Context 

The  PDES  (Product  Data  Exchange  using  STEP)  activity  is  the  United  States’  effon  in 
suppon  of  the  Standard  for  the  Exchange  of  Product  Model  Data  (STEP),  an  emerging 
international  standard  for  the  interchange  of  product  data  between  various  vendors’ 
CAD/CAM  systems  and  other  manufacturing-related  software  [SmithSS].  A  National 
PDES  Testbed  has  been  established  at  the  National  Institute  of  Standards  and  Technol¬ 
ogy  to  provide  testing  and  validation  facilities  for  the  emerging  standard.  The  Testbed 
is  funded  by  the  CALS  (Computer-aided  Acquisition  and  Logistic  Support)  program  of 
the  Office  of  the  Secretary  of  Defense.  As  pan  of  the  testing  effon,  NIST  is  charged 
with  providing  a  software  toolkit  for  manipulating  PDES  data.  This  NIST  PDES  Tool¬ 
kit  is  an  evolving,  research-oriented  set  of  software  tools.  This  document  is  one  of  a  set 
of  repons  which  describe  various  aspects  of  the  Toolkit.  An  overview  of  the  Toolkit  is 
provided  in  [Clark90a],  along  with  references  to  the  other  documents  in  the  set. 

For  funher  information  on  the  STEP  Working  Form  or  other  components  of  the  Toolkit, 
or  to  obtain  a  copy  of  the  software,  use  the  attached  order  form. 
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2  STEPparse  Control  Flow 

A  STEPparse  translator  consists  of  two  separate  passes:  parsing  and  output  generation. 
The  first  pass  builds  an  instantiated  Product  representing  the  product  model  specified 
in  the  STEP  input  file.  This  Product  can  then  be  traversed  by  an  output  module  in 
the  second  pass,  producing  whatever  report  is  desired.  It  is  anticipated  that  users  will 
need  output  formats  other  than  those  provided  with  the  NIST  Toolkit.  The  process  of 
writing  a  report  generator  for  a  new  output  format  is  discussed  in  detail  in  section  4. 

2.1  First  Pass:  Parsing 

The  first  pass  of  a  STEPparse  translator  is  a  very  simple  parser.  The  STEPparse  gram¬ 
mar  itself  is  independent  of  any  conceptual  schema.  The  lexical  analyzer  recognizes 
any  entity  class  name  simply  as  an  identifier,  the  actions  associated  with  rules  in  the 
grammar  then  interpret  th's  name  as  refering  to  a  particular  Express  entity,  and  con¬ 
struct  appropriate  objects.  As  each  construct  is  parsed,  it  is  added  to  the  Working  Form. 
Because  the  STEP  physical  file  format  does  not  allow  forward  references  to  as-yet-un- 
defined  entity  instances,  all  symbol  references  can  be  (and  are)  resolved  during  this 
parsing  pass,  so  that  no  symbol  resolution  pass  is  required. 

The  STEPparse  parser  is  written  using  the  standard  UNIX^'*  parser  generation  languag¬ 
es,  Yacc  and  Lex.  The  grammar  is  processed  by  Bison,  the  Free  Software  Founda¬ 
tion’s'  implementation  of  Yacc.  The  lexical  analyzer  is  produced  by  Flex^,  a  fast. 
Public  Domain  implementation  of  Lex. 

2.2  Second  Pass:  Output  Generation 

The  repon  or  output  generation  pass  manages  the  production  of  the  various  output  files. 
In  the  dynamically  linked  version  of  STEPparse,  this  pass  loads  successive  output  mod¬ 
ules  dynanaically,  calling  each  to  traverse  the  Working  Form.  The  dynamic  linking 
mechanism  is  discussed  briefly  in  [CIark90d].  It  is  also  possible  to  build  a  statically 
linked  translator,  with  a  particular  output  module  loaded  in  at  build  time;  this  is,  in  fact, 
the  only  mechanism  available  in  an  environment  which  is  not  derived  from  BSD  4.2 
UNIX. 

A  report  generator  is  an  object  module,  most  likely  written  in  C,  which  has  been  com¬ 
piled  as  a  component  module  for  a  larger  program  (i.e.,  with  the  -c  option  to  a  Unix  C 
compiler).  In  the  dynamically  linked  version,  the  object  module  is  linked  into  the  run¬ 
ning  parser,  and  its  entry  point  (by  convention  a  function  called  print_f  ile  ( ) )  is 


1 .  The  Free  Software  Foundation  (FSF)  of  Cambridge,  Massachusetts  is  responsible  for  the  GNU  Project, 
whose  ultimate  goal  is  to  provide  a  free  implementation  of  the  UNIX  operating  system  and  environment. 
These  tools  are  not  in  the  Public  Etomain;  FSF  retains  ownership  and  copyright  priviledges,  but  grants  free 
distribution  rights  under  certain  terms.  At  this  writing,  further  information  is  available  by  electronic  mail  on 
the  Internet  from  gnu@prep.ai.miLedu. 

2.  Vem  Paxson’s  Fast  Lex  is  usually  distributed  with  GNU  software,  although,  being  in  the  Public  Domain, 
it  is  not  an  FSF  product  and  does  not  come  under  the  FSF  licensing  restrictions. 
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called.  The  code  of  this  module  consists  of  calls  to  STEP  Working  Form  access  func¬ 
tions  and  to  standard  output  routines.  Chapter  4  provides  a  detailed  description  of  the 
creation  of  a  new  output  module. 

3  Working  Form  Implementation 

As  in  the  Express  Working  Form  [ClarkQOd],  the  Object  abstraction  is  implemented  as 
a  Symbol  header  block  with  a  pointer  to  a  private  struct  Object.  This  C  structure 
contains  the  real  definition  of  the  abstraction,  but  is  never  manipulated  directly  outside 
of  the  Object  module.  Product  is  implemented  as  a  pointer  to  a  private  structure, 
struct  Product. 

Most  stylistic  and  other  conventions  from  the  Express  Working  Form  are  equally  valid 
for  STEP;  they  are  reiterated  here  for  emphasis. 

3.1  Primitive  Types 

The  STEP  Working  Form  makes  use  of  several  modules  from  the  Toolkit  general  li¬ 
braries,  including  the  Error  and  Linked_List  modules.  These  are  described  in 
[Clark90d]. 

3.2  STEP  Working  Form  Manager  Module 

In  addition  to  the  abstractions  discussed  in  [Clark90c],  1  ibst  ep .  a  contains  one  more 
(conceptual)  module,  the  package  manager.  Defined  in  step .  c  and  step .  h,  this 
module  includes  calls  to  intialize  the  entire  STEP  (and  Express)  Working  Form  pack¬ 
age,  and  to  run  each  of  the  passes  of  a  STEPparse  translator. 

3.3  Code  Organization  and  Conventions 

Each  abstraction  is  implemented  as  a  separate  module.  Modules  share  only  their  inter¬ 
face  specifications  with  other  modules.  A  module  Foo  is  composed  of  two  C  source 
files,  f  oo .  c  and  f  oo .  h.  The  former  contains  the  body  of  the  module,  including  all 
non-inlined  functions.  The  latter  contains  function  prototypes  for  the  module,  as  well 
as  all  type  and  macro  definitions.  In  addition,  global  variables  are  defined  here,  using 
a  mechanism  which  allows  the  same  declarations  to  be  used  both  for  extern  declara¬ 
tions  in  other  modules  and  the  actual  storage  definition  in  the  declaring  module.  These 
globals  can  also  be  given  constant  initializers.  Finally,  f  oo  .  h  contains  inline  function 
definitions.  In  a  compiler  which  suppons  inline  functions,  these  are  declared  static 
inline  in  every  module  which  includes  foo .  h,  including  foo .  c  itself.  In  other 
compilers,  they  are  undefined  except  when  included  in  foo .  c,  when  they  are  compiled 
as  ordinary  functions,  foo .  c  resides  in  ~pdes/src/step/;  foo.hin 
-pdesZ include/. 

The  type  defined  by  module  Foo  is  named  Foo,  and  its  private  structure  is  struct 
Foo.  Access  functions  are  named  as  FOO  function  ( ) ;  this  function  prefix  is  abbre¬ 
viated  for  longer  abstraction  names,  so  that  access  functions  for  type 
Foolhardy_Bartender  might  be  of  the  form  FOO_BARf  unction  ( ) .  Some 
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functions  may  be  implemented  as  macros;  these  macros  are  not  distinguished  typo¬ 
graphically  from  other  functions,  and  are  guaranteed  not  to  have  unpleasant  side  effects 
like  evaluating  arguments  more  than  once.  These  macros  are  thus  virtually  indistin¬ 
guishable  from  functions.  Functions  which  are  intended  for  internal  use  only  are  named 
FOO_f  unction  ( ) ,  and  are  usually  static  as  well,  unless  this  is  not  possible.  Glo¬ 
bal  variables  are  often  named  FOO_var  iable;  most  enumeration  identifiers  and  con¬ 
stants  are  named  FOO_CONSTANT  (although  these  latter  two  rules  are  by  no  means 
universal). 

Every  abstraction  defines  a  constant  FOO_NULL,  which  represents  an  empty  or  missing 
value  of  the  type.  In  addition,  there  are  several  operations  which  are  defined  for  every 
type;  these  are  primarily  general  management  operations.  Each  abstraction  defines  at 
least  one  creation  function,  e.g.  FOOcreate  ( ) .  The  parameters  to  this  creation  func¬ 
tion  vary,  depending  on  the  abstraction.  A  permanent  copy  of  an  object  (as  opposed  to 
a  temporary  copy  which  will  immediately  be  read  and  discarded)  can  be  obtained  by 
calling  FOOcopy  ( too) .  This  helps  the  system  keep  track  of  references  to  an  object, 
ensuring  that  it  is  not  prematurely  garbage-collected.  Similarly,  when  an  object  or  a 
copy  is  no  longer  needed,  it  should  be  released  by  calling  FOOf  ree  ( f  oo) ,  allowing 
it  to  be  garbage -collected  if  appropriate. 

For  each  abstraction,  there  is  a  function  FOOis_foo  (ob  j )  which  returns  true  if 
and  only  if  its  argument  is  a  foo.  This  is  useful  when  dealing  with  a  heterogeneous  list, 
for  example. 

3.4  Memory  Management  and  Garbage  Collection 

In  reading  various  portions  of  the  STEP  Working  Form  documentation,  one  may  get  the 
impression  that  the  Working  Form  does  some  reasonably  intelligent  memory  manage¬ 
ment.  This  is  not  true.  The  NIST  PDES  Toolkit  is  primarily  a  research  tool.  This  is 
especially  true  of  the  Express  and  STEP  Working  Forms.  The  Working  forms  allocate 
huge  chunks  of  memory  without  batting  an  eye,  and  this  memory  often  is  not  released 
until  an  application  exits.  Hooks  for  doing  memory  management  do  exist  (e.g., 

XXXf  ree  ( )  and  reference  counts),  but  currently  are  largely  ignored. 

3.5  Object 

The  Object  abstraction  is  the  basic  building  block  of  the  STEP  Working  Form.  An 
Object  is  created  for  each  unit  of  value  in  a  PDES/STEP  product  model:  each  entity 
instance,  aggregate,  integer,  string,  etc.  On  the  surface,  this  would  seem  to  be  a  reason¬ 
ably  straightforward  module  to  implement:  each  Object  has  an  optional  name,  a 
Type,  and  a  value.  The  value  may  be  simple  or  structured;  in  either  case,  it  basically 
comes  down  to  a  pointer  -  either  to  an  array  of  Objects,  or  to  an  integer,  real,  string, 
etc. 

As  with  most  abstractions  in  the  Express  Working  Form,  Object  is  implemented  as  a 
Symbol  header  whose  definition  field  points  at  a  struct  Object,  which  is 
defined  thus: 

struct  Object  { 
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Type  type; 

Generic  user_data; 

union  { 

Constant  enumeration; 

Integer  integer; 

Logical  log'  al; 

Real  real; 

String  string; 

Object*  entity; 

Aggregate  aggregate; 

}  value; 

}; 

The  first  two  fields  are  pretty  straightforward.  Note  that  user_ciata  is  a  generic 
pointer  field.  In  strict  ANSI  C,  only  a  pointer  can  be  safely  stored  into  this  field  and 
later  retrieved;  it  is  safest  to  only  store  pointers  in  this  field.  In  particular,  the  age-old 
trick  of  casting  pointers  and  integers  back  and  forth,  never  completely  portable,  is  now 
officially  frowned  upon. 

The  value  union  is  where  things  get  tricky.  This  field  contains  the  actual  value  of  the 
object  represented.  Unstructured  types  (numbers,  logicals,  and  strings)  are  represented 
directly:  e.g.,  object  .value .  integer  contains  an  integer,  and 
object  .value .  string,  a  character  pointer.  The  value  of  an  enumeration  object 
is  represented  as  a  Constant,  which  will  be  an  element  of  the  appropriate  enumera¬ 
tion.  The  integer  representation  of  this  enumeration  element  can  be  retrieved  by  calling 
(int) CSTget_value (object .value. enumeration) . 

An  entity  instance’s  value  field,  value .  ent  it  y,  is  a  pointer  to  the  base  of  an  array 
of  objects.  Each  element  of  this  array  corresponds  to  an  attribute  of  the  entity;  attributes 
appear  in  the  same  order  as  in  a  PDES/STEP  physical  file,  with  empty  attributes  explic¬ 
itly  represented  by  OB  JECT_NULL.  The  offset  to  a  particular  attribute  value  is  re¬ 
trieved  from  the  Express  data  dictionary  by  calling 

ENTITYget_attribute_of  fset  (entity,  attribute) ,  where  entity  is 
the  entity  class  of  the  object  in  question  and  attribute  is  the  Variable  represent¬ 
ing  the  attribute  to  be  located. 

The  most  convoluted  object  value  representation  is  that  for  aggregates.  An  aggregate 
value  is  represented  as  a  pointer  to  a  struct  Aggregate,  defined  as 

struct  Aggregate  { 

int  low; 

int  high; 

Expression  max; 

Object*  contents; 

} ; 

The  last  field,  contents,  holds  the  actual  contents  of  the  aggregate,  as  an  array  of 
Objects.  The  low  field  provides  a  lower  bound  on  allowable  indices  into  this  array, 
and  doubles  as  a  logical  offset  to  the  first  element  of  the  array.  This  value  is  1  for  any 
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non-array  aggregate.  Thus,  when  low  is  1,  some_aggregate  [  1  ]  is  found  at 
contents  [0].  Similarly,  in  an  array  whose  low  is  10,  the  some_array  [12  ]  is 
found  at  contents  [  12-10  =  2].  low  remains  constant  in  any  particular  aggre¬ 
gate  object.  The  high  field  gives  an  upper  bound  on  the  indices  of  currently  filled  slots 
in  an  aggregate  object.  Every  index  into  the  aggregate  beyond  high  which  is  in  bounds 
is  guaranteed  to  return  OB  JECT_NULL.  The  end  result  is  that  a  loop  of  the  form 
for  (i  =  low;  i  <=  high;  ++i)  <use  contents  [ i-low]  >  will  al¬ 
ways  hit  all  of  the  elements  of  an  aggregate.  This  function  of  offsetting  by  the  lower 
bound  is  bundled  into  the  various  aggregate  indexing  functions  of  the  working  form 
(OBJaggr_at  ( ) ,  OBJlist_insert  ()  ,etc.),  so  that  the  indices  which  a  user  sees 
will  be  the  ones  which  would  be  expected  based  on  the  Express  model.  In  the  current 
implementation,  high  in  an  aggregate  whose  type  (from  Express)  gives  a  finite  upper 
bound  always  remains  constant  at  this  bound.  In  the  case  of  an  aggregate  with  no  spec¬ 
ified  upper  bound,  however,  high  may  vary  with  the  number  of  elements  actually  in 
the  aggregate.  The  expression  (from  Express)  giving  the  absolute  upper  bound  on  an 
aggregate  is  cached  in  aggregat  e->max.  high  is  never  allowed  to  be  greater  than 
the  value  of  this  expression. 

The  two  calls  OB  Jaggr_at  ( )  and  OB  Jaggr_at_put  ( )  can  be  used  with  any  kind 
of  aggregate,  although  they  are  intended  to  be  used  primarily  for  building  general  ag¬ 
gregates  which  will  later  be  OB  Jtype_cast  ( )  into  specific  types  of  aggregates. 
This  is  how  STEPparse  builds  aggregates,  since  it  is  considerably  easier  than  figuring 
out  at  parse  time  what  type  of  aggregate  should  be  built.  The  various  class-specific  ma¬ 
nipulations  (list  concatenation,  set  intersection,  etc.)  are  provided  by  calls  requiring  ag¬ 
gregates  of  a  particular  class:  OB  Jlist_concat  0  ,OBJset_intersect  ()  ,etc. 
It  should  be  noted  that  the  calls  for  combning  aggregates  are  destructive:  each  modifies 
its  first  argument  to  hold  its  computed  result.  In  general,  the  two  arguments  may  safely 
be  set  equal.  Exceptions  are  noted  in  the  individual  function  specifications. 

Finally,  a  word  about  type  conversion  (also  known  as  casting,  as  in  C).  Type  conver¬ 
sions  of  existing  Objects  are  handled  by  OBJtype_cast  (Object,  Type, 
Error*) .  Only  certain  conversions  are  allowed;  other  attempted  casts  leave  the 
Object  unchanged  and  return  an  error  code.  Clearly,  any  Object  can  trivially  be 
cast  into  its  own  type.  The  different  numeric  types  can  be  cast  about  at  will.  A  general 
aggregate  can  be  cast  into  any  specific  aggregate  class;  otherwise,  an  aggregate  can 
only  be  cast  into  another  aggregate  type  of  the  same  class:  an  array  cannot  be  cast  into 
a  set,  etc.  Each  element  of  the  aggregate  being  cast  must,  of  course,  be  recursively  cast 
into  the  appropriate  base  type;  each  of  these  conversions  is  subject  to  the  same  rules  as 
any  other  cast.  Finally,  an  entity  Object  can  be  converted  into  an  instance  of  a  super¬ 
type  of  its  class,  or  into  an  instance  of  a  SELECT  type  containing  some  type  to  which 
it  can  be  cast.  These  casts  of  entity  instances  in  fact  do  not  modify  the  Object  being 
cast. 

3.6  Product 

A  product  in  STEP  contains  a  large  number  of  interrelated  entity  instances,  and  is  rep¬ 
resented  by  the  Product  abstraction.  Each  Product  is  named,  and  includes  a  point¬ 
er  to  the  Express  model  which  provides  the  scope  in  which  its  component  Objects  are 
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defined.  These  component  objects  can  be  retrieved  from  the  Product  in  several 
ways:  a  specific  (external)  entity  instance  can  be  retrieved  by  name;  a  Linked_List 
of  all  of  the  (external)  entity  instances  in  the  P  roduct  can  be  requested;  or  a  particular 
entity  class  in  the  P  roduct ’s  conceptual  schema  can  be  queried  for  all  of  its  instances 
(note  that  this  last  method  retrieves  both  internal  and  external  entity  instances).  Internal 
(embedded)  entity  instances  and  non-entity  Objects  must  appear  as  attribute  values 
or  aggregate  elements  somewhere  in  the  Product,  and  are  only  accessible  via 
ENTlTYget_instances  ( )  and  component  retrieval  from  the  containing 
Objects. 

The  above  three  access  methods  are  supported  by  storing  three  references  to  each 
Object  in  a  Product.  When  an  Object  is  added  to  a  Product,  it  is  added  to  the 
end  of  the  list  of  external  objects.  This  list  preserves  the  order  in  which  the  Objects 
were  added  to  the  Product,  and  so  is  appropriate  for  applications,  such  as  writing  a 
STEP  physical  file,  which  require  that  there  be  no  forward  references  to  as-yet-unde- 
fined  Objects.  Each  external  Object  is  also  added  to  a  dictionary  which  the 
Product  maintains,  to  allow  retrieval  by  name.  And  when  an  entity  object  is  first  cre¬ 
ated,  it  is  added  to  the  instance  list  of  its  class. 

4  Writing  An  Output  Module 

We  now  turn  to  the  topic  of  actually  writing  a  repon  generator.  The  end  result  of  this 
process  will  be  an  object  module  (UNIX  .  o  file)  which  can  be  loaded  into  STEPparse. 
This  module  contains  a  single  entry  point  which  traverses  a  given  Product  and  writes 
its  output  to  a  particular  file.  The  conceptual  entry  point  is  conventionally  called 
print_f  ile  ( ) ,  while  the  physical  entry  point,  which  simply  dispatches  to 
print_f  ile  ( ) ,  is  called  entry_point  () . 

In  most  cases,  there  will  be  a  one-to-one  correspondence  between  Objects  in  the  instan¬ 
tiated  Working  Form  and  records  to  be  written  on  the  output.  When  this  is  the  case,  the 
meat  of  the  report  generator  can  be  made  fairly  simple.  Since  a  list  of  all  of  the  Objects 
in  the  Working  Form  is  available,  it  is  easy  to  iterate  over  this  list  and  output  each  Ob¬ 
ject  in  sequence; 

STEPprint (Product  product,  FILE*  file) 

{ 

Linked_List  list; 

list  =  PRODget_contents (product ) ; 

LISTdo(list,  obj.  Object) 

OBJprint (ob j,  file); 

LISTod; 

} 

The  only  remaining  problem  is  to  write  a  function  OBJprint  ( )  which  emits  the  out¬ 
put  record  for  a  single  Object.  Given  the  variety  of  types  of  Objects,  this  function  will 
probably  be  controlled  by  a  large  switch  statement,  selecting  on  the  Object’s  type 
class  (numbers,  strings,  and  aggregates  all  have  to  be  printed  differently).  Code  to  deal 
with  multi -dimensional  arrays  an  internal/external  entity  references  can  get  tricky,  and 
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should  be  written  carefully.  An  example  of  a  fairly  simple  report  generator  is  that  used 
by  STEPparse-QDES.  The  source  code  for  this  module  is  in 
~pdes/src/STEPparse_qdes/step_output_smallt:alk .  c. 

4.1  Layout  of  the  C  Source 

The  layout  of  the  C  source  file  for  a  report  generator  which  will  be  dynamically  loaded 
is  of  critical  importance,  due  to  the  primitive  level  at  which  the  load  is  carried  out.  The 
very  first  piece  of  C  source  in  the  file  must  be  the  entry_point  ( )  function,  or  the 
loader  may  find  the  wrong  entry  point  to  the  file,  resulting  in  mayhem.  Only  comments 
may  precede  this  function;  even  an  #  include  directive  may  throw  off  the  loader.  An 
output  module  is  normally  layed  out  as  shown: 

void 

entry_point (void*  product,  void*  file) 

{ 

extern  void  print_f ile ( ) ; 
print_file (product ,  file); 

} 


#include  "step.h" 

. . .  actual  output  routines  . 


void 

print_f ile (void*  product,  void*  file) 

{ 

print_f ile_header ( (Product) product, 

(FILE*) file) ; 

STEPprint  (product,  file) ; 

print_f ile_trailer ( (Product) product, 

(FILE*) file) ; 

) 

The  print_f  ile  ( )  function  will  probably  always  be  quite  similar  to  the  one  shown, 
although  in  many  cases,  the  file  header  and/or  trailer  may  well  be  empty,  eliminating 
the  need  for  these  calls.  In  this  case,  STEPprint  ( )  andprint_file  ()  will  prob¬ 
ably  become  interchangeable. 

Having  said  all  of  the  above  about  templates,  code  layout,  and  so  forth,  we  add  the  fol¬ 
lowing  note:  In  the  final  analysis,  the  output  module  really  is  a  free-form  piece  of  C 
code.  There  is  one  and  only  one  rule  which  must  be  followed:  The  entry  point  (accord¬ 
ing  to  the  a .  out  format)  to  the  .  o  file  which  is  produced  when  the  report  generator  is 
compiled  must  be  appropriate  to  be  called  with  a  Product  and  a  FILE*.  The  sim¬ 
plest  (and  safest)  way  of  doing  this  is  to  adhere  strictly  to  the  layout  given,  and  write  an 
ent  ry_point  ( )  routine  which  jumps  to  the  real  (conceptual)  entry  point.  But  any 
other  convention  which  guarantees  this  property  may  be  used. 
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4.2 


5 


5.1 


Output  Module  Linkage  Mechanisms 

One  of  the  powers  of  STEPparse  is  the  flexibility  which  it  gives  a  user  with  regard  to 
generating  output.  An  important  component  of  this  flexibility  on  BSD  Unix  systems  is 
the  dynamic  loading  of  output  modules.  Both  static  and  dynamic  binding  of  output 
modules  are  supported  by  STEPparse.  This  is  implemented  by  physically  breaking  the 
object  code  from  the  Working  Form  manager  (step .  c)  into  three  separate  .  o  files: 
the  initialization  code  and  the  first  pass  of  STEPparse  are  compiled  into  step .  o, 
which  is  stored  in  1  ibst  ep .  a.  The  static  linking  version  of  the  second  pass  (without 
any  output  module)  is  compiled  into  step_stat  ic .  o;  and  the  dynamic  loading  ver¬ 
sion  into  step_dynainic .  o.  Sources  for  all  of  these  components  reside  in  step .  c; 
the  various  sections  are  extracted  via  conditional  compilation:  When  this  file  is  com¬ 
piled  with  the  preprocessor  symbols  reports  and  static_reports  defined, 
step_stat  ic .  o  is  produced.  With  reports  and  dynamic_reports  defined, 
step_dynamic .  o  is  produced;  and  with  none  of  these  defined,  step .  o  is  pro¬ 
duced. 

Since  step_static .  o  and  step_dynamic .  o  both  define  the  function 
STEPreport  ( ) ,  only  one  can  be  linked  into  any  given  executable.  This  selection  is 
what  determines  whether  a  STEPparse  translator  links  in  output  modules  statically  or 
dynamically.  Note  that  a  suitable  output  module  ( .  o  file)  must  appear  after 
step_stat  ic .  o  in  the  linker’s  argument  list  when  a  statically  linked  translator  is 
being  built. 

Working  Form  Routines 


The  remainder  of  this  manual  consists  of  specifications  and  brief  descriptions  of  the  ac¬ 
cess  routines  and  associated  error  codes  for  the  STEP  Working  Form.  The  error  codes 
are  manipulated  by  the  Error  module  [Clark90d].  Each  subsection  below  corresponds 
to  a  module  in  the  Working  Form  library.  The  Working  Form  Manager  module  is  listed 
first,  followed  by  the  remaining  data  abstractions  in  alphabetical  order. 


Working  Form  Manager 


Procedure: 

Parameters: 

Returns: 

Description: 


Errors: 


STEPinitialize 

Error*  crrc  -  buffer  for  error  code 
void 

Initialize  the  STEP  Working  From  package.  In  a  typical  STEP  uanslator  this  is  called 
by  the  default  main  ( )  provided  in  the  Working  Form  library.  Other  applications 
should  call  this  function  at  initialization  time, 
none 


Procedure: 

Parameters: 

Returns: 

Description: 


STEPparse 

Suing  filename  -  the  name  of  the  file  to  be  parsed 

Express  data_modcl  -  conceptual  schema  (as  produced  by  EXPRESSpass_2  ( ) ) 

Product  -  the  product  model  parsed 

Parse  a  STEP  physical  file  into  the  Working  Form 
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Procedure: 

Parameters: 

Returns: 

Description: 

Description: 


5.2  Object 

Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 


Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 


Procedure: 

Parameters: 

Returns: 

Description: 

Errors: 

Procedure: 

Parameters: 

Returns: 

Description: 


Errors: 
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STEPreport 

Product  product  -  the  product  to  output 
void 

Invoke  one  or  more  report  generators  for  a  STEP  Working  Form  model. 

Invoke  one  (or  more)  report  generator(s).  When  this  function  is  compiled  with 
-Ddynamic_reports,  it  will  repeatedly  prompt  for  report  generators  and  output 
files,  dynamically  loading  and  executing  them.  When  it  is  compiled  with 
-Dst  at  ic_repo  rt  s,  a  report  generator  must  also  be  included  at  link  time,  with  the 
entry  point  print_f  ile  (Express ,  FILE* ) . 


OBJaggr_at 

Object  object  -  object  to  examine 
int  index  -  index  of  requested  clement 
Error*  erre  -  buffer  for  error  code 
Object  -  value  at  requested  position 

Reu-ieves  the  value  at  some  position  in  an  aggregate.  Note  that  the  calls  which  are 
specific  to  a  particular  aggregate  class  are  much  to  be  preferred. 
ERROR_index_out_of_range  -  the  index  is  outside  of  the  bounds  of  the 
aggregate 

OBJaggr_at_put 

Object  object  -  object  to  modify 

int  index  -  index  at  which  to  put  element 

Object  value  -  value  to  insert 

Error*  emc  -  buffer  for  error  code 

void 

Store  a  value  into  an  aggregate  object  Note  that  the  calls  which  are  specific  to  a 
particular  aggregate  class  are  much  to  be  preferred. 

ERROR_index_out__of_Eange  -  the  index  is  outside  of  the  bounds  of  the 
aggregate 

OBJaggr_lowcr_bound 
Object  object  -  object  to  examine 
Error*  enc  -  buffer  for  error  code 
int  -  the  lower  bound  of  the  object 

Retrieves  the  lower  bound  of  an  aggregate  object  For  an  array,  this  is  the  index  of  the 

first  element  of  the  array.  For  other  aggregates,  it  is  1. 

none 


OBJaggr_upper_bound 
Object  object  -  object  to  examine 
Error*  eirc  -  buffer  for  error  code 
int  -  the  upper  bound  of  the  object 

Retrieves  the  upper  bound  of  an  aggregate  object  For  an  aggregate  with  a  constrained 
size,  this  is  the  value  of  the  upper  limit  or  index.  For  an  aggregate  with  an  infinite 
upper  bound,  the  value  returned  is  guaranteed  to  be  larger  than  the  highest  index  of  a 
filled  slot  in  the  aggregate, 
none 
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Procedure:  OBJarTay_at 

Parameters:  Object  array  -  array  to  examine 

int  index  -  index  of  requested  element 
Error*  errc  -  buffer  for  error  code 
Returns:  Object  -  value  at  requested  position 

Description:  Retrieves  the  value  at  some  position  in  an  array. 

Errors:  ERROR_index_out_of_cange  -  the  index  is  outside  of  the  bounds  of  the 

aggregate 

Procedure:  OBJarray_at _put 

Parameters:  Object  array  -  array  to  modify 

int  index  -  index  at  which  to  put  element 
Object  value  -  value  to  insert 
Error*  errc  -  buffer  for  error  code 
Returns:  void 

Description:  Store  a  value  into  an  array  object. 

Errors:  ERROR_index_out_of_range  -  the  index  is  outside  of  the  bounds  of  the 

aggregate 

Procedure:  OBJbag_add 

Parameters:  Object  bag  -  bag  to  modify 

Object  item  -  item  to  add 
Error*  errc  -  buffer  for  error  code 
Returns:  void 

Description:  Inserts  an  object  into  a  bag. 

Errors:  ERROR_bag_f  ull  -  there  is  no  more  room  in  the  bag 

Procedure:  OBJbag_includes 

Parameters:  Object  bag  -  bag  to  test 

Object  item  -  item  to  test  for 
Error*  errc  -  buffer  for  error  code 
Returns:  Boolean  -  does  this  bag  contain  this  item? 

Errors:  none 

Procedure:  OBJbag_intersect 

Parameters:  Object  bag  -  bag  to  intersect  into 

Object  unitee  •  bag  to  intersect  with 
Error*  errc  -  buffer  for  error  code 
Returns:  void 

Description:  Intersects  two  bags.  This  operation  is  destructive:  the  first  bag  holds  the  resulting 

intersection  on  return. 

Errors:  none 

Procedure:  OBJbag_remove 

Parameters:  Object  bag  -  bag  to  remove  from 

Object  item  -  item  to  remove 
Error*  errc  -  buffer  for  error  code 
Returns:  void 

Description;  Remove  a  single  occurence  of  some  item  from  a  bag,  if  it  appears. 

Errors:  none 
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Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 

Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 

Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 

Procedure: 

Parameters: 

Returns: 

Procedure: 

Parameters: 

Returns: 

Errors: 


Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 


OBJbag_remove_all 
Object  bag  -  bag  to  remove  from 
Object  remove  -  bag  of  items  to  remove 
Error*  enc  -  buffer  for  error  code 
void 

Removes  all  items  in  a  bag  from  some  other  bag.  This  is  bag  subtraction.  This 

operation  is  destructive;  the  first  bag  holds  the  result  on  return. 

none 

OBJbag_subset 

Object  bag  -  bag  to  test  as  superset 

Object  subset  -  bag  to  test  as  subset 

Error*  enc  -  buffer  for  error  code 

Boolean  -  docs  the  Hrst  bag  contain  the  second  as  a  subset? 

This  implementation  is  not  completely  correct.  In  particular,  the  following  returns 

true;  OBJbag_subset ( (a,  b,  c},  {a,  a}). 

none 

OBJbag_unite 

Object  bag  -  bag  to  unite  onto 
Object  unitee  -  bag  to  unite  with 
Error*  erre  -  buffer  for  error  code 
void 

Adds  the  contents  of  a  bag  to  another  bag.  This  operation  is  destructive;  the  first  bag 

holds  the  resulting  union  on  return.  It  is  not  safe  to  unite  a  bag  with  itself. 

none 

OBJeopy 

Object  object  -  object  to  copy 
Object  -  a  shallow  copy  of  the  object 

OBJereate 

Type  type  -  type  to  instantiate 

Error*  enc  -  buffer  for  error  code 

Object  -  a  new,  empty  object  of  the  given  type 

ERROR_cannot_instant  iate  -  the  type  given  cannot  be  instantiated  (e.g.. 
Generic) 

OBJcreate_entity 

Entity  entity  -  entity  class  to  instantiate 

Linked.List  attributes  -  list  of  attribute  values 

int  line  -  source  line  number  of  the  instance  to  be  created 

Error*  enc  -  buffer  for  enor  code 

Object  -  a  new  entity  instance,  as  described 

A  new  object  of  the  specified  entity  type  is  created.  There  should  be  a  one-to-one 
correspondence  between  the  values  on  the  attribute  value  list  and  the  list  of  attributes 
for  the  entity  being  instantiated. 

ERROR  insuf  f  icient_attributes  -  not  enough  attribute  values  in  the  list 
provide? 

ERROR_too_many_attributes  -  too  many  attribute  values  in  the  list  provided 
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Procedure: 

Parameters: 


Returns: 

Description: 


Errors: 

Procedure: 

Parameters: 


Returns: 

Requires: 

Description: 


Errors: 

Procedure: 

Parameters: 

Returns: 

Description: 

Errors: 

Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 

Procedure: 

Parameters: 

Returns: 

Errors: 
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OBJcrcate_ud_entity 

Create  a  user-defined  entity.  This  procedure  is  not  yet  implemented. 

OBJ  fast_get_attribute 
Object  object  -  object  to  examine 
Variable  attribute  -  attribute  to  retrieve 
Error*  emc  -  buffer  for  error  code 
Object  -  value  of  aiuibute 

Retrieves  the  value  of  an  atuibute  from  an  entity  instance.  This  call  is  faster  than 
OBJget_att  r  ibute  ( )  when  the  caller  already  has  the  actual  ataibute  record  for 
the  desired  attribute,  rather  than  simply  having  its  name  (as  expected  by 
OBJget_attribute  ( ) ). 
none 

OBJfast_put_aitribute 
Object  object  -  object  to  modify 
Variable  attribute  -  attribute  to  store  into 
Object  value  -  value  to  store  into  attribute 
Error*  erre  -  buffer  for  error  code 
void 

TYPEgct_class(OBJget_typc(object))  ==  TYPE_ENTITY 
Store  a  value  into  an  attribute  of  an  entity  instance.  This  call  is  faster  than 
OBJput_attribute  O  when  the  caller  already  has  the  actual  attribute  record  for 
the  desired  attribute,  rather  than  simply  having  its  name  (as  expected  by 
OBJput_attr ibute  ( )  ). 

Same  as  for  OBJput_attr ibute  ( ) . 

OBJfree 

Object  object  -  object  to  free 
Error*  enc  -  buffer  for  error  code 
void 

Release  an  Object.  Indicates  that  the  object  is  no  longer  used  by  the  caller;  if  there  are 
no  other  references  to  the  object,  all  storage  associate  with  it  may  be  released, 
none 

OBJget_attribute 

Object  object  -  object  to  examine 

String  attributeName  -  name  of  attribute  to  retrieve 

Error*  erre  -  buffer  for  error  code 

Object  -  value  of  the  named  attribute 

Retrieves  the  value  of  a  named  attribute  from  an  entity  instance.  This  call  is  the  slower 
method  for  retrieving  an  attribute  value.  If  the  actual  attribute  recored  is  already 
available,  use  OBJf  a3t_get_attribute  ( )  instead, 
none 

OBJget_line_numbcr 
Object  object  -  object  to  examine 
int  -  line  number  of  object 
none 
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Procedure: 

Parameters: 

Returns: 

Description: 

Errors: 

Procedure: 

Parameters: 

Returns: 

Errors: 

Procedure: 

Parameters: 

Returns: 

Errors: 

Procedure: 

Parameters: 

Returns: 

Description: 


Errors: 

Procedure: 

Parameters: 

Returns: 

Description: 

Errors: 

Procedure: 

Parameters: 

Returns: 

Errors: 

Procedure: 

Parameters: 

Returns: 

Errors: 


OBJget_name 

Object  object  -  object  to  examine 
String  -  the  object’s  name 

Retrieves  the  name  of  an  object  Unnamed  objects,  which  would  nonnally  be 

embedded  entities  and  non-entities,  yield  STR1NG_NULL. 

none 

OBJget_type 

Object  object  -  object  to  examine 
Type  -  the  type  of  the  object 
none 

OBJgct_uscr_data 

Object  object  -  object  to  examine 

Error*  erre  -  buffer  for  error  code 

Generic  -  value  of  user  data  field  for  this  object 

none 

OBJget_value 

Object  object  -  object  to  examine 
Error*  enc  -  buffer  for  error  code 
Generic  -  the  object’s  value 

Retrieves  the  value  of  a  single-valued  object  The  value  returned  will  be  a  cha  r  *  for 
a  string  object,  a  Constant  for  an  enumeration  object  and  a  pointer  to  an  int, 
double,  or  Boolean  for  an  integer,  real,  or  logical  object,  respectively.  See 
OBJarray_at  < ) , OBJbag^includes ( ) ,  OBJlist_at ( ) ,  and 
OBJset_at()  to  read  from aggregate.  SeeOBJget_attribute()  to  read 
from  an  entity  instance, 
none 

OBJinitialize 

Error*  erre  -  buffer  for  error  code 
void 

Initialize  the  Object  module.  This  is  called  by  STEPinitializeO. 
none 

OBJis_extemal 

Object  object  -  object  to  examine 

Boolean  -  is  this  an  external  object  (non-embedded  entity)? 

none 

OBJis_intemal 

Object  object  -  object  to  examine 

Boolean  -  is  this  an  internal  object  (embedded  entity)? 

none 
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Procedure; 

Parameters: 


Returns: 

Description: 

Errors: 

Procedure: 

Parameters; 


Returns: 

Description: 

Errors: 

Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 


OBJlist_add_first 
Object  list  -  list  to  modify 
Object  item  -  item  to  insert 
Error*  errc  -  buffer  for  error  code 
void 

Adds  an  item  to  the  beginning  of  a  list.  This  function  is  not  yet  implemented, 
none 

OBJlist_add_last 
Object  list  -  list  to  modify 
Object  item  -  item  to  insert 
Error*  errc  -  buffer  for  error  code 
void 

Adds  an  item  to  the  end  of  a  list  This  function  is  not  yet  implemented, 
none 

OBJlist_concat 

Object  list  -  list  to  concatenate  onto 
Object  tail  -  list  to  concatenate 
Error*  errc  -  buffer  for  error  code 
void 

Concatenate  a  list  onto  the  end  of  another.  This  operation  is  destructive;  the  first  list 
is  modified  so  that  it  includes  a  copy  of  the  second.  Changes  to  the  second  will  not 
appear  in  the  first.  This  function  is  not  yet  implemented, 
none 
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Procedure: 
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Requires: 

Description: 


Errors: 


Procedure: 

Parameters: 

Returns: 

Description: 

Errors: 


OBJpuLattribute 

Object  object  -  object  to  modify 

String  aitributeName  -  name  of  attribute  to  store  into 

Object  value  -  value  to  store  into  attribute 

Error*  enc  -  buffer  for  error  code 

void 

TYPEget_class(OBJgct_iype(objeci))  ==  TYPE_ENTITY 
Stores  a  value  into  a  named  attribute  of  an  entity  instance.  This  call  is  the  slower 
method  for  storing  into  an  attribute.  If  the  actu^  attribute  record  is  available,  for 
example  from  traversing  the  Entity’s  attribute  list,  use 
OBJfast_put_attribute  ( )  instead. 

ERROR_aggregate_expected  -  value  given  for  an  aggregate  was  not  an 
aggregate 

ERROR_array_expected  -  value  given  for  an  array  was  not  an  array 
ERROR_bag_expected  -  value  given  for  a  bag  was  not  a  bag 
ERROR  entity  expected  -  value  given  for  an  entity  was  not  an  entity 
ERROR_external_expected  -  an  external  attribute  was  given  an  internal 
(embedded)  entity  as  a  vaJue 

ERROR  inappropriate_entity  -  the  entity  given  as  a  value  was  not  of  an 
expected  class 

ERROR_integer_expected  -  value  given  for  an  integer  was  not  an  integer 
ERROR  internal_expected  -  an  internal  attribute  was  given  an  external 
entity  reference  as  a  value 

ERROR_list_expected  -  value  given  for  a  list  was  not  a  list 
ERROR_logical_expected  -  value  given  for  a  logical  was  not  a  logical 
ERROR_nuinber_expected  -  value  given  for  a  number  was  not  a  number 
ERROR_set_expected  -  value  given  for  a  set  was  not  a  set 
ERROR_st  r  ing_expected  -  value  given  for  a  string  was  not  a  string 
ERROR_incompatible_types  -  the  value  given  is  not  of  the  expected  type,  in 
some  way  not  covered  by  any  of  the  above  messages 

OBJput_linc_number 
Object  object  -  object  to  modify 
int  number  -  line  number  for  object 
void 

Set  an  object's  line  number, 
none 


Procedure: 

Parameters: 

Returns: 

Description: 

Errors: 


OBJput_name 

Object  object  -  object  to  modify 
String  name  •  name  for  object 
void 

Sets  the  name  (identiner)  of  an  object;  normally,  only  entity  instances  which  are  not 

embedded  are  named. 

none 


Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 


OBJput_user_data 

Object  object  -  object  to  modify 

Generic  value  -  user  data  value  for  object 

Error*  erre  -  buffer  for  error  code 

Generic  -  old  value  of  user  data  Held  for  this  object 

Stores  a  value  into  an  object’s  user  data  field 

none 


« 


t 
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Procedure: 

Parameters: 


Returns: 

Description: 


Errors: 

Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 

Procedure: 

Parameters: 


Returns: 

Errors: 

Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 

Procedure: 

Parameters: 


Returns: 

Description: 

Errors: 


OBJpul_valuc 

Object  object  -  object  to  modify 
Generic  value  -  value  for  object 
Error*  erre  -  buffer  for  error  code 
void 

Sets  the  value  of  a  single-valued  object.  The  value  given  should  be  a  char*  for  a 
suing  object  For  an  integer,  real,  or  logical  object,  it  should  be  an  int  *,  double*, 
and  Boolean*,  respectively.  For  an  enumeration  object  the  value  given  should  be 
of  type  Constant.  See  OBJaggr_at_put ( ) ,  OBJarray_at_put ( ) , 
OBJbag_add ( ) ,  OBJlist_add_f irst ( ) , OBJlist_add_last ( ) ,  and 
OBJset_add()  to  store  into  an  aggregate.  See  OBJput_attribute  ( )  to  store 
into  an  entity  instance, 
none 

OBJset_add 

Object  set  -  set  to  modify 
Object  item  -  item  to  add 
Error*  erre  -  buffer  for  error  code 
void 

Inserts  an  object  into  a  set  if  it  is  not  already  present 
ERROR_set_f  ull  -  there  is  no  more  room  in  the  set 

OBJset_includes 

Object  set  -  set  to  test 

Object  item  -  item  to  test  for 

Error*  enc  -  buffer  for  error  code 

Boolean  -  docs  this  set  contain  this  item? 

none 

OBJseiJntersect 

Object  set  -  set  to  intersect  into 

Object  with  -  set  to  intersect  with 

Error*  eirc  -  buffer  for  error  code 

void 

Intersects  two  sets.  This  operation  is  destructive:  the  Hrst  set  holds  the  resulting 

intersection  on  return. 

none 

OBJset_remove 

Object  set  -  set  to  remove  from 

Object  item  -  item  to  remove 

Error*  erre  -  buffer  for  error  code 

void 

Remove  an  item  from  a  set,  if  it  appears, 
none 
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Procedure:  OBJset_remove_all 

Parameters:  Object  set  -  set  to  remove  from 

Object  remove  -  set  of  items  to  remove 
Error*  eric  -  buffer  for  error  code 
Returns:  void 

Description:  Removes  all  items  in  a  set  from  some  other  set.  This  is  set  subtraction.  This  operation 

is  desmictive:  the  first  set  holds  the  result  on  return. 

Errors:  none 

Procedure:  OBJset_subset 

Parameters:  Object  set  -  set  to  test  as  superset 

Object  subset  -  set  to  test  as  subset 
Error*  cnc  -  buffer  for  error  code 

Returns:  Boolean  -  does  the  first  set  contain  the  second  as  a  subset? 

Errors:  none 

Procedure:  OBIset_unitc 

Parameters:  Object  set  -  set  to  unite  onto 

Object  unitee  -  set  to  unite  with 
Error*  errc  -  buffer  for  error  code 
Returns:  void 

Description:  Forms  the  union  of  two  sets.  This  operation  is  destructive:  the  first  set  holds  the 

resulting  union  on  return. 

Errors:  none 

Procedure:  OBJtype_cast 

Parameters:  Object  object  -  object  to  be  cast 

Type  type  -  type  to  cast  to 
Error*  ertc  -  buffer  for  error  code 
Returns:  Object  -  the  object,  cast  to  the  requested  type 

Description:  Converts  an  object  to  a  new  type,  if  possible.  Ifthe  cast  is  successful  (*errc  == 

ERROR  none),  the  original  object  should  no  longer  be  used.  It  is  guaranteed  to  be 
valid  otiTy  when  an  error  is  reported.  This  call  does  not  report  errors  to  stderr;  it  is 
the  callers  responsibility  to  check  *errc  and  to  call  ERRORreport  ( *errc, 
(String)  context)  if  it  is  not  ERROR_none. 

Errors:  ERROR_aggregate_expected  -  value  given  for  an  aggregate  was  not  an 

aggregate 

ERROR_array_expected  -  value  given  for  an  array  was  not  an  array 
ERROR_bag_expected  -  value  given  for  a  bag  was  not  a  bag 
ERROR_ent  ity_expected  -  value  given  for  an  entity  was  not  an  entity 
ERROR  inappropriate_entity  -  the  entity  given  as  a  value  was  not  of  an 
expected  class 

ERROR_integer_expected  -  value  given  for  an  integer  was  not  an  integer 
ERROR_list_expected  -  value  given  for  a  list  was  not  a  list 
ERROR_logical_expected  -  value  given  fora  logical  was  not  a  logical 
ERROR_nuinber_expected  -  value  given  for  a  number  was  not  a  number 
ERROR_set_expected  -  value  given  for  a  set  was  not  a  set 
ERROR_string_expected  -  value  given  for  a  string  was  not  a  string 
ERROR_incompatible_types  -  the  value  given  is  not  of  the  expected  type,  in 
some  way  not  covered  by  any  of  the  above  me.ssages 
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5.3 


Product 

Procedure: 

PRODadd_object 

Parameters: 

Product  product  -  product  to  modify 

Object  object  -  entity  instance  to  add 

Returns: 

void 

Requires: 

TYPEget_class(OBJget_type(object))  ==  TYPE_ENTITY 

Description: 

Adds  an  entity  instance  to  a  product  .model.  The  instance  is  assumed  already  to  have 
been  added  to  the  instance  list  of  its  class,  since  OBJcreate_ent  ity  ( )  does  this. 

Errors: 

none 

Procedure: 

Parameters: 

Returns: 

Description: 

Errors: 


PRODcreaie 

Siring  name  -  name  for  new  product 

Express  model  -  conceptual  schema  in  which  to  create  product 
Product  -  a  new,  empty  product 

Creates  an  empty  product  within  a  particular  conceptual  schema, 
none 


Procedure: 

Parameters: 

Returns: 

Errors: 


PRODget_conceptuaLschema 

Product  product  -  product  to  examine 

Express  •  conceptual  schema  in  which  the  product  exists 

none 


Procedure: 

Parameters: 

Returns: 

Description: 

Errors: 


PRODget_contents 

Product  product  •  product  to  examine 

Linked_List  -  entity  instances  which  make  up  the  product 

Retrieves  a  list  of  the  objects  in  a  product  model,  in  the  order  in  which  they  were 

created. 

none 


Procedure: 

Parameters: 

Returns: 

Errors: 


PRODgei_name 

Product  product  -  product  to  examine 
String  •  the  name  of  the  product 
none 


Procedure: 

Parameters: 

Returns: 

LDescription: 

Errors: 


PRODget_named_object 
Product  product  •  product  to  examine 
String  name  -  name  of  object  to  reuieve 
Object  -  the  named  object 

Retrieves  a  named  object  from  a  STEP  product  model,  if  it  is  defined, 
none 


Procedure: 

Parameters: 

Returns: 

Description: 

Errors: 


PRODintiialize 
-  none  -- 
void 

Initializes  the  Product  module.  This  is  called  by  STEPinitializeO- 
none 
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6  STEP  Working  Form  Error  Codes 

The  Error  module,  which  is  used  to  manipulate  these  error  codes,  is  described  in 
[Clark90d].  All  STEP  Working  Form  error  codes  are  defined  in  the  Object  module. 

Error:  ERROR_aggregale_expected 

Severity:  SEVERITY.ERROR 

Meaning:  A  non-aggregate  value  was  provided  for  an  aggregate  attribute 

Format:  %s  -  attribute  name 

Error:  ERROR_array_cxpected 

Severity:  SEVERITY_ERROR 

Meaning:  An  aggregate  of  a  specific  non-array  class  was  provided  for  an  array  attribute 

Format:  %s  -  attribute  name 

Error:  ERROR_bag_expected 

Severity:  SEVERITY_ERROR 

Meaning:  An  aggregate  of  a  specific  non-bag  class  was  provided  for  a  bag  attribute 

Format:  %s  -  attribute  name 

Error:  ERROR_bag_full 

Severity;  SEVERITY_WARNING 

Meaning:  An  item  was  inserted  into  an  already  full  bag 

Format:  --  none  -- 

Error:  ERROR_cannot_instaniiate 

Severity:  SEVER1TY_ERR0R 

Meaning:  An  attempt  was  made  to  instantiate  an  uninstantiable  type 

Format:  %s  -  type  name 

Error:  ERROR_eniiiy_expected 

Severity:  SEVERITY_ERROR 

Meaning:  A  non-entity  Object  was  provided  for  an  attribute  having  an  entity  type 

Format:  %s  -  attribute  name 

Error;  ERROR_extemal_expected 

Severity:  SEVERITY.WARNING 

Meaning:  An  embedded  (internal)  entity  was  provided  for  an  attribute  with  "external"  reference 

class 

Format:  %s  -  attribute  name 

Error:  ERROR_inappropriate_entity 

Severity:  SEVERITY.ERROR 

Meaning:  An  entity  of  the  wrong  type  was  provided  for  an  attribute  having  an  entity  type 

Format:  %s  -  attribute  name 

Error:  ERROR_incompatible_types 

Severity:  SEVERITY_ERROR 

Meaning:  Some  other  type  problem  was  encountered  in  specifying  an  attribute  of  some  object 

Format:  %$  -  attribute  name 


NIST  STEP  Working  Form  Programmer’s  Reference 


Page  20 


Stephen  Nowland  Clark 


Error: 

Severity: 

Meaning: 

Format: 

ERROR_index_oui_of_range 

SEVERITY_WARNING 

An  attempt  was  made  to  index  an  aggregate  object  outside  of  the  legal  bounds 
%d  -  index  value 

Error: 

Severity: 

Meaning: 

Format: 

ERROR_insufficicni_attributcs 

SEVERITY_WARNING 

Too  few  attribute  values  were  provided  for  a  particular  entity  instantiation 
%s  -  entity  instance  identifier 

Error: 

Severity: 

Meaning: 

Format: 

ERROR_integer_expected 

SEVERITY_ERROR 

A  non-integer  value  was  provided  for  an  integer  attribute 
%s  -  attfibute  name 

Error: 

Severity: 

Meaning: 

Format: 

ERROR_intemal_expectcd 

SEVERITY_WARNING 

An  non-embedded  (external)  entity  was  provided  for  an  attribute  with  "internal 
reference  class 
%s  -  attribute  name 

Error: 

Severity: 

Meaning: 

Format: 

ERROR_tist_cxpected 

severity_error 

An  aggregate  of  a  specific  non-list  class  was  provided  for  a  list  attribute 
%s  -  attribute  name 

Error: 

Severity: 

Meaning: 

Format: 

ERROR_logical_expecied 

severity_error 

A  non-logical  value  was  provided  for  a  logical  attribute 
%s  -  attribute  name 

Error: 

Severity: 

Meaning: 

Format: 

ERROR_number_expected 

SEVERITY.ERROR 

A  non-numeric  value  was  provided  for  a  numeric  attribute 
%s  -  attribute  name 

Error: 

Severity: 

Meaning: 

Format: 

ERROR_set_duplicate_entry 

SEVERITY.ERROR 

A  duplicate  entry  was  added  to  a  set 
-  none  - 

Error: 

Severity: 

Meaning: 

Format: 

ERROR_set_expected 

severity.error 

An  aggregate  of  a  specific  non-set  class  was  provided  for  a  set  attribute 
%s  -  attribute  name 

Error: 

Severity: 

Meaning: 

Format: 

ERROR_set_full 

SEVERITY.WARNING 

An  item  was  inserted  into  an  already  full  set 
-  none  - 
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Error: 

Severity: 

Meaning: 

Format: 

Error: 

Severity: 

Meaning: 

Format: 

Error: 

Severity: 

Meaning: 

Format: 

Error: 

Severity: 

Meaning: 

Format: 


ERROR_string_expccted 

SEVERITY.ERROR 

A  non-string  Object  was  provided  for  a  string  attribute 
%s  -  attribute  name 

ERROR_too_many_aitributes 

SEVERITY_WARNING 

Too  many  attribute  values  were  provided  for  a  particular  entity  instantiation 

%s  -  entity  instance  identifier  < 

ERROR_undefined_reference 

SEVERITY_ERROR  ( 

A  reference  was  made  to  an  unknown  entity  instance  identifier 
%s  -  entity  instance  identifier 

ERROR_unknown_entity 

SEVERITY_ERROR 

A  reference  was  made  to  an  unknown  entity  class  (type) 

%s  -  entity  class  name 


I 
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